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Introducing Compile and Runtime Errors in Java 

This module introduces a collection of modules on identifying and 
correcting errors in programs written in the Java programming languages. It 
covers both compile-time errors and runtime errors (exceptions). The 
compile-time errors are discussed both for Sun's compiler and the Eclipse 
compiler. 


Acknowledgement: Otto Seppald and Niko Myller contributed many 
helpful suggestions. 


Compilation errors 


Compilers are notorious for their obscure error messages like “not a 
statement” that leave you wondering what they mean. Java is the most 
widely used language for teaching and learning introductory programming, 
and most students and teachers use the Sun SDK (System Development Kit) 
either directly or indirectly through a development environment like BlueJ 
or DrJava. The error messages produced by this compiler are terse and 
many novices find it difficult to achieve even syntactically correct 
programs. This document is a guide to understanding and fixing errors in 
Java. 


There are three modules relating to errors discovered at compilation time: 
Syntax Errors in Java, Semantic Errors in Java and Structural Errors in 
Java. There are two modules on exceptions (errors discovered when the 
program is run): Exceptions in Java and Executing a Java Program. Since 
many errors arise from misunderstandings of Assignment and Equality in 
Java, there is a module that explains how they work with reference 
semantics. Finally, module Debugging Java Programs Without a Debugger 
will help you debug Java programs. 


The Eclipse development environment has its own compiler for Java. While 
the environment is not as elementary as those intended for novices, it has 
much to recommend it—even in introductory courses—because of its 
superior error messages and its support for identifying and correcting 
syntax errors. The compiler is incremental meaning that it checks the 


correctness of your program as you type. Eclipse error message are different 
from those of the Sun SDK and will be presented alongside them. 


If you doubt that an error message is correct, you can consult the formal 
definition of the Java language which is contained in the book The Java 
Language Specification by James Gosling, Bill Joy, Guy L. Steele Jr. and 
Gilad Bracha. It can also be downloaded from 
http://java.sun.com/docs/books/jls/index.html. 


Before we discuss the various errors, it is important to understand that 
compilers are not very good at recovering from errors. Frequently, a single 
small mistake will cause the compiler to issue a cascade of messages. For 
example, in the following code, we forgot to write the closing brace of the 
method Ff: 


Class MyClass { 
void f() { 
int n = 10; 
// Error, closing brace 
is missing 
void g() { 
int m = 20; 
} 


i 


An attempt to compile the program results in three error messages: 


MyClass.java:5: illegal start of expression 
void g() { 
rN 


MyClass.java:8: ';' expected 


Zi 


rN 
MyClass.java:9: '}' expected 
rN 


Do not invest any effort in trying to fix multiple error messages! 
Concentrate on fixing the first error and then recompile. 


Eclipse: Syntax error, insert "}" to complete MethodBody. Eclipse is 
much better at diagnosing this error and produces only one message. 


Runtime errors 


When the Java interpreter encounters an error during runtime it throws an 
exception and prints a stack trace showing the entire call stack—the list of 
methods called from the main program until the statement that caused the 
exception.[footnote] Consider the following program: 

Many programming languages prefer the term raises an exception and even 
The Java Language Specification uses this term on occasion. 


Class Test { 
public static void main(String[] args) { 
String s = "Hello world"; 
System.out.printiln(s.substring(10,12)); 


i 
} 


We are trying to extract a substring of the string s but the upper index 12 is 
not within the string. Attempting to execute this code will cause an 
exception to be thrown: 


Exception in thread "main" 
java. lang.StringIndexOutOfBoundsException: 
String index out of range: 12 
at java.lang.String.substring(Unknown Sour 
ce) 
at Test.main(Test.java:4) 


The exception was thrown from within the library class Str ing during the 
execution of the method Substring. This method was called at line 4 of 
method main in the class Test. It is unlikely that there is an error that 
causes an exception in a well established class of the Java library like 
String; more likely, the String class itself identified the error and 
threw the exception explicitly, so we are advised to seek the error starting at 
the deepest method of our own program. 


The calls in the stack trace are listed in reverse order of invocation, that is, 
the first call listed is the deepest method (where the exception occurred), 
while the last call listed is the shallowest method, namely main. 


Exceptions can be caught by writing a block of code called an exception 
handler that will be executed when an exception is thrown.[footnote | 
Exception handlers are discussed in textbooks on the Java language; here 
we limit ourselves to explaining the exceptions that indicate programming 
errors. We further limit ourselves to exceptions commonly thrown by the 
language core; classes in the API define their own exceptions and these are 
explained in the API documentation. 

An alternate terminology is to say that an exception is handled by an 
exception handler. 


Syntax Errors in Java 
Basic syntax errors in Java are explained. 


Some errors are caused by violations of the syntax of Java. Although they 
are easy to understand, there is no easy way to find the exact cause of such 
errors except by checking the code around the location of the error 
character by character looking for the syntax error. 


..expected 


The syntax of Java is very specific about the required punctuation. This 
error occurs, for example, if you forget a semicolon at the end of a 
statement or don't balance parentheses: 


if (1 > j // Error, unbalanced parentheses 
max = 1 // Error, missing semicolon 

else 
max = j; 


Unfortunately, this syntax error is not necessarily caught precisely at the 
point of the mistake so you must carefully check the preceding characters in 
the line or even in a previous line in order to find the problem. 


Eclipse: 
Syntax error, insert ") Statement" to complete IfStatement 


Syntax error, insert ";" to complete Statement 
Eclipse is more informative as to the precise syntax error encountered. 


unclosed string literal 


String literals must be enclosed in quotation marks.[footnote] This error 
occurs if you fail to terminate the literal with quotation marks. Fortunately, 
the syntax of Java requires that a string literal appear entirely on one line so 
the error message appears on the same line as the mistake. If you need a 
string literal that is longer than a single line, create two or more literals and 
concatenate them with +: 


A literal is a source-code representation of a value; most literals are of 
primitive types like int or char, but there are also literals of type 
String and the literal nU11 of any reference type. 


String longString = 
"This is first half of a long string " + 
"and this is the second half."; 


Eclipse: String literal is not properly closed by a double-quote In 
Eclipse you can write a string literal of arbitrary length and the environment 
will break the string and insert the + automatically. 


illegal start of expression 


Most programming constructs are either statements or expressions. This 
error occurs when an expression is expected but not found. In Java, an 
assignment statement is considered to be an expression which returns a 
value, so errors concerning expressions also apply to assignment 
statements.[ footnote] Examples: 

The value of an assignment statement considered as an expression is the 
value of the expression on the right-hand side that is assigned to the 
variable on the left-hand side. 


e An extra right parenthesis after the condition of an 1f-statement: 

Oe (hae ))k 4) // Error, extra parenthesis 
max = 1; Eclipse: Syntax error on token ")", delete this 

token| footnote] Eclipse diagnoses this as a simple syntax error and 
does not mention expressions. 
The syntax of a programming language is defined in terms of tokens 
consisting of one or more characters. Identifiers and reserved 
keywords are tokens as are single characters like + and sequences of 
characters like ! =. 

¢ Forgetting the right-hand side of an assignment statement: 
max = ; // Error, missing right - 
hand side Eclipse: Syntax error on token "=", Expression 
expected after this token 


not a statement 


This error occurs when a syntactically correct statement does not appear 
where it should. Examples: 


e Writing an assignment statement without the assignment operator: 


max }; // Error, missing = Eclipse: Syntax 
error, insert "AssignmentOperator Expression" to complete 
Expression 

e Misspelling else: if (1 > Jj) max = 1; 
els ; // Error, else not spelled corre 


ctly The reason you do not get “else expected” is that you need not 
write an else alternative so this just looks like a bad statement. 


Eclipse: 
els cannot be resolved 
Syntax error, insert "AssignmentOperator Expression" to 
complete Expression 
The same identifier can be used in different methods and classes. An 
important task of the compiler is to resolve the ambiguity of multiple 
uses of the same identifer; for example, if a variable is declared both 
directly within a class and also within a method, the use of its 
unqualified name is resolved in favor of the local variable. This error 
message simply means that the compiler could not obtain an 
(unambiguous) meaning for the identifier els. 

e The following code: if (1 > j) max = 1; 
els // Error, else not spelled correc 
tly max = jj; results in a weird error message: 
x: jJava:6: Galinot Tina symbol 
symbol : class els location: class x els The 
reason is that the compiler interprets this as a declaration: 
els max = Jj; andcan't finda class els as the type of the 
variable max. 
Eclipse: Duplicate local variable maxels cannot be resolved to a 
type These messages are more helpful: first, the use of the word type 
instead of class is more exact because the type of a variable need not 
be a class (it could be a primitive type or interface); second, the 


message about the duplicate variable gives an extra clue as to the 
source of the error. 
e The error can also be caused by attempting to declare a variable whose 
name is that of a reserved keyword: void f() { 
int default = 10; } Eclipse:Syntax error on token 
"default", invalid VariableDeclaratorId 


cannot find symbol 


This is probably the most common compile-time error. All identifiers in 
Java must be declared before being used and an inconsistency between the 
declaration of an identifier and its use will give rise to this error. Carefully 
check the spelling of the identifier. It is easy to make a mistake by using a 
lower-case letter instead of an upper case one, or to confuse the letter O 
with the numeral 0 and the letter | with the numeral 1. 


Other sources of this error are: calling a constructor with an incorrect 
parameter signature, and using an identifier outside its scope, for example, 
using an identifier declared in a For-loop outside the loop: 


int[] a = {1, 2, 3}; 
int sum 0; 
for (int 1 = 0; 1 < a.length; i++) 
sum = sum + a[i]; 
System.out.printiln("Last = " + 1); // Error 
, 1 not in scope 


Eclipse: ... cannot be resolved 


... is already defined in... 
An identifier can only be declared once in the same scope: 


int sum = 0; 
double sum = 0.0; // Error, sum already defined 


Eclipse: Duplicate local variable sum 


array required but ... found 
This error is caused by attempting to index a variable which is not an array. 
int max(int i, int j) { 

if (1 > Jj) return i; 


else return j[i]; // Error, j 1s no 
t an array 


Eclipse: The type of the expression must be an array type but it 
resolved to int 


... has private access in ... 
It is illegal to access a variable declared private outside its class. 


Eclipse: The field ... is not visible 


Semantic Errors in Java 
A Java program can be syntactically correct but still not compile because of 
errors related to the semantics of the language. 


This group of errors results from code that is syntactically correct but 
violates the semantics of Java, in particular the rules relating to type 
checking. 


variable ... might not have been initialized 


An instance variable declared in a class has a default initial value.[footnote | 
However, a local variable declared within a method does not, so you are 
required to initialize it before use, either in its declaration or in an 
assignment statement: 

A class is a template that is used to create or instantiateinstances called 
objects. Since memory is allocated separately for each object, these 
variables are called instance variables. 


void m(int n) { // Nn is initialized from the act 
ual parameter 


int 1, j; 
1 = 2; // 1 1S initialized by the as 
signment 
int k = 1; // k is initialized in its de 
claration 
if (1 == n) // OK 
kK = j; // Error, j 1S not initialize 
d 
else 
J = 
t 


The variable must be initialized on every path from declaration to use even 
if the semantics of the program ensure that the path cannot be taken: 


void m(int n) { 
int 1; 


if (n == n) // Always true 


1 = a 
else 
n= 1; // Error, although never e 
xecuted! ! 


i 


Eclipse: The local variable ... may not have been initialized 


Note: If the expression in the if-statement can be computed at compile- 
time: 


if (true) // OK 
if ('n' == 'n') // OK 


the error will not occur. 


.. in... cannot be applied to ... 


This error message is very common and results from an incompatibility 
between a method call and the method's declaration: 


void m(int i) { ... } 


m(5.5); // Error, the literal is of type do 
uble, not int 


Check the declaration and call carefully. You can also get the error message 
cannot find symbol if the declaration of the method is in the API.[ footnote | 
The Application Programming Interface (API) describes how to use the 
library of classes supplied as part of the Java system. By extension, it is also 
used as a name for the library itself. 


Eclipse: The method ... in the type ... is not applicable for the 
arguments ... 


operator ... cannot be applied to ...,... 


Operators are only defined for certain types, although implicit type 
conversion is allowed between certain numeric types: 


int a = 5; 
boolean b = true; 
int c=a+); 
value 

double d =a+41.4; // OK, int is implicitly conv 
erted to double 


// Error, can't add a boolean 


Eclipse: The operator + is undefined for the argument type(s) int, 
boolean 


possible loss of precision 


This error arises when trying to assign a value of higher precision to a 
variable of lower precision without an explicit type cast. Surprisingly, 
perhaps, floating point literals are of type double and you will get this 
message if you try to assign one to a variable of type float: 


float sum = 0.0; // Error, literal is not 
of type float 


The correct way to do this is to use a literal of type f Loat or an explicit 
type cast: 


Float sum 
Float sum 


0.0Ff; // OK 
(float) 0.0; // OK 


Eclipse: Type mismatch: cannot convert from double to float 


incompatible types 


Java checks that the type of an expression is compatible with the type of the 
variable in an assignment statement and this error will result if they are 
incompatible: 


boolean b = true; 
int a =); // Error, can't assign boo 
lean to int 


Eclipse: Type mismatch: cannot convert from boolean to int 


Important note 

In the C language it is (unfortunately!) legal to write if (a = b) using 
the assignment operator instead of if (a == b) using the equality 
operator. The meaning is to execute the assignment, convert the value to an 
integer and use its value to make the decision for the 1 f-statement (zero is 
false and non-zero is true). In Java, the assignment is legal and results in a 
value, but (unless a is of type boolean!) this error message will result 
because the expression in an if-statement must be of type boolean, not 
int. Writing == instead of = becomes a simple compile-time error in Java, 
whereas in C this error leads to runtime errors that are extremely difficult to 
find. 


inconvertible types 

Not every type conversion is legal: 

boolean b = true; 

int x = (int) b; // Error, can't convert boolean 
to int 


Eclipse: Type mismatch: cannot convert from ... to ... 


Structural Errors in Java 

This module describes compilation errors that result from incorrect methods 
(primarily incorrect return statements) and incorrect use of the static 
attribute. 


Methods and return statements 


There are a number of errors related to the structure of methods and their 
return statements; in general they are easy to fix. 


missing return statement 


When a method returns a non-void type, every path that leaves the method 
must have a return-statement,| footnote |even if there is no way that the 
path can be executed: 

A path may also leave the method via a throw statement. 


int max(int i, int j) { 
if (1 > j) return i; 
else if (i <= j) return j; 
// Error: what about the path when 1i>j, i<=j are 
both false?! ! 


} 


Adding a dummy alternative else return 0; at the end of the method 
will enable successful compilation. 


Eclipse:This method must return a result of type int This Eclipse 
message is rather hard to understand because, clearly, the method does 
return a result of type Lnt, just not on all paths. 


missing return value 


A method returning a type must have a return-statement that includes an 
expression of the correct type: 


int max(int i, int j) { 


return; // Error, missing int exp 
ression 


} 


Eclipse: This method must return a result of type int 


cannot return a value from method whose result type is void 


Conversely, a re turn-statement in a void method must not have an 
expression: 


void m(int i, int j) { 


return 1 + Jj; // Error, the method was 
declared void 


} 


Eclipse: Void methods cannot return a value 


invalid method declaration; return type required 


Every method except constructors must have a return type or vOid 
specified; if not, this error will arise: 


max(int i, int j) { 


} 


The error frequently occurs because it is easy to misspell the name of a 
constructor; the compiler then thinks that it is a normal method without a 
return type: 


Class MyClass { 

MyClass(int 1) { ... } 

Myclass(int 1, int j) { ... } // Error: lowerc 
ase C 


} 


Eclipse: Return type for the method is missing 


unreachable statement 
The error can occur if you write a statement after a return statement: 


void m(int j) { 
System.out.println("Value is " + j); 
return, 
jtt; 


The check is purely syntactic, so the error will occur in the following 
method: 


if (true) { 
return n + 1; // Only this alternative ex 
ecuted, but 
} 
else { 
return n - 1; 
n=n+t%1; // ... this 1S an error 
} 


Eclipse: Unreachable code 


Access to static entities 


The modifier Static means that a variable or method is associated with a 
class and not with individual objects of a class.[footnote] Normally, static 


entities are rarely used in Java (other than for the declaration of constants), 
because programs are written as classes to be instantiated to create at least 
one object: 

static has other uses that we do not consider here: (a) as a modifier for 

nested classes and (b) in static initializers. 


Class MyClass { 
int field; 
void m(int parm) { 
field = parm; 
} 
public static void main(String[] args) { 
MyClass myclass = new MyClass(); // Create 
object 
myclass.m(5); // Call ob 
ject's method 
System.out.println(myclass.field); // Access 
object's field 
} 
7 


Some teachers of elementary programming in Java prefer to start with a 
procedural approach that involves writing a class containing static variables 
and static methods that are accessed from the main method without 
instantiating an object as was done above: 


Class MyClass1 { 
static int field; 
static void m(int parm) { 
field = parm; 


public static void main(String[] args) { 
m(5); // OK 
System.out.println( field); // OK 
} 


non-static variable ... cannot be referenced from a static context 


Since the method main is (required to be) static, so must any variable 
declared in the class that is accessed by the method. Omitting the modifier 
results in a compile-time error: 


int field; // Forgot "static" 


System.out.println(field); // Error, which fiel 
d? 


The variable Field does not exist until an object of the class is 
instantiated, so using the identifier field by itself is impossible before 
objects are instantiated. Furthermore, it is ambiguous afterwards, as there 
may be many objects of the same class. 


Eclipse: Cannot make a static reference to the non-static field ... 


non-static method ... cannot be referenced from a static context 


Similarly, a non-static method cannot be called from a static method like 
main; the reason is a bit subtle. When a non-static method like m is 
executed, it receives as an implicit parameter the reference to an object. 
(The reference can be explicitly referred to using this.) Therefore, when it 
accesses variables declared in the class like Field: 


void m(int parm) { // Forgot "static" 
field = parm; // Error, which fiel 

d? 

} 


public static void main(String[] args) { 
m(5); 
} 


it is clear that the variable is the one associated with the object referenced 
by this. Thus, in the absence of an object, it is meaningless to call a non- 
static method from a static method. 


Eclipse: Cannot make a static reference to the non-static method ... 
from the type ... 


Exceptions in Java 
This module explains the various exceptions that are raised by the Java 
Runtime Environment. 


Out of range 


These exceptions are the most common and are caused by attempting to 
access an array or string with an index that is outside the limits of the array 
or string. C programmers will be familiar with the difficult bugs that are 
caused by such errors which “smear” memory belonging to other variables; 
in Java the errors cause an exception immediately when they occur thus 
facilitating debugging. 


ArrayIndexOutOfRange 


This exception is thrown when attempting the index an array a[ 1] where 
the index i is not within the values © and a. length-1, inclusive. Zero- 
based arrays can be confusing; since the Length of the array is larger than 
the last index, it is not unusual to write the following in a For-statement by 
mistake: 


final static int SIZE = 10; 
int a = new int[SIZE]; 


for (int 1 = 0; 1 <= SIZE; i++) // Error, <= Ss 
hould be < 


for (int 1 = 0; 1 <= a.length; i++) // Better, but 
still an error 


StringIndexOutOfRange 


This exception is thrown by many methods of the class Str ing if an index 
is not within the values 0 and s. Llength( ), inclusive. Note that 


s.length( ) is valid and means the position just after the last character in 
the string. 


NullPointerException 


A variable in Java is either of a primitive type such as int or boolean or 
of a reference type: an array type, the type of a class defined in the Java API 
such as String, or the type of a class that you define such as MyClass. 
When declaring a variable of a reference type, you only get a variable that 
can hold a reference to an object of that class. At this point, attempting to 
access a field or method of the class will cause the exception 
NullPointerException to be thrown:[footnote] 

The name of the exception is an anachronism, because there are no 
(explicit) pointers in Java. 


Class YourClass { 
static MyClass my; // Can hold a reference bu 
t doesn't yet 


public static void main(String[] args) { 
my.m(5); // Throws NullPointerExcep 
tion 
i; 
} 


Only after instantiating the class and executing the constructor do you get 
an object: 


Class YourClass { 
static MyClass my; // Can hold a reference bu 
t doesn't yet 


public static void main(String[] args) { 
my = new MyClass(); // Instantiates an object 
// and assigns the refer 
ence 
my.m(5); // Throws NullPointerExcep 


tion 


This exception is not often seen in this context because Java style prefers 
that the declaration of the variable include the instantiation as its initial 
value: 


Class YourClass { 
// Declaration + instantiation of class variable 
static MyClass my1 = new MyClass(); 


public static void main(String[] args) { 
my1.m(5); // OK 
// Declaration + instantiation of local variab 
le 
MyClass my2 = new MyClass(); 
my2.m(5); // OK 
J 
J 


Sometimes, you cannot initialize a variable at its declaration; an obvious 
place to initialize an instance variable is within its constructor: 


Class YourClass { 


MyClass[] my; // Can't initialize here 
because 
YourClass(int size) { // ... size of array diff 


erent for each 
object my = new MyClass[size]; 
y 


} 


The exception is likely to occur when you declare an array whose elements 
are of reference type. It is easy to forget that the array contains only 
references and that each element must be separately initialized: 


MyClass[] my = new MyClass[4]; 
eferences 

my[1].m(5); 

exception 


for (int 1 = 0; 1 < my.length; itt) 


my[i] = new MyClass(); 
e objects 
my[1].m(5); 


// Array of r 


// Raises an 


// Instantiat 


// OK 


Finally, NuLLPointerException will occur if you get a reference as a 
return value from a method and don't know or don't check that the value is 
non-null:[ footnote] 

You could know this if the method has been verified for a postcondition that 
specifies a non-null return value. 


Node node = getNextNode(); 
if (node.key > this.key) 
ode is null! 


// Error if n 


if (node != null) { // This shoul 
d be done first 


if (node.key > this.key) 
; 


Computational errors 


The following three exceptions occur when you try to convert a string to a 
number and the form of the string does not match that of a number, for 
example "12a3". 


InputMismatchException 


This exception is thrown by the class Scanner, which is a class 
introduced into version 5 of Java to simplify character-based input to 


programs. 


IllegalFormatException 


This exception is thrown by the method format in class String that 
enables output using format specifiers as in the C language. 


NumberFormatException 


This exception is thrown by methods declared in the numeric “wrapper” 
classes such as Integer and Doub Le, in particular by the methods 
parseInt and parseDoub1e that convert from strings to the primitive 
numeric types. 


ArithmeticException 
This exception is thrown if you attempt to divide by zero. 


Important note 

Most computational errors do not result in the raising of an exception! 
Instead, the result is an artificial value called NaN, short for Not a Number. 
This value can even be printed: 


double x = Math.sqrt(-1); // Does not throw an ex 
ception! 
System.out.println(x); 


Any attempt to perform further computation with NaN does not change the 
value. That is, if x is NaN then so is y after executing y = X+5. It follows 
that an output value of NaN gives no information as to the statement that 
first produced it. You will have to set breakpoints or use print statements to 
search for it. 


Insufficient memory 


Modern computers have very large memories so you are unlikely to 
encounter these exceptions in routine programming. Nevertheless, they can 
occur as a side effect of other mistakes. 


outOfMemoryError 
This exception can be thrown if you run out of memory: 


int a = new int[100000000]; 


StackOverFlowArea 


A stack is used to store the activation record of each method that is called; it 
contains the parameters and the local variables as well as other information 
such as the return address. Unbounded recursion can cause the Java Virtual 
Machine to run out of space in the stack: 


int factorial(int n) { 

if (n == 0) return 1; 

else return n * factorial(n + 1); // Error, you 
meant n - 1 


} 


Executing a Java Program 

To run a Java program, the interpreter must be invoked with an argument 
giving the name of the main method. This module explains the exceptions 
that can be raised if the name is incorrect. 


You can run a Java program from within an environment or by executing 
the interpreter from the command line: 


java Test 
where TeSt is the name of a class containing a main method. 


Suggestion: It is convenient to write main methods in most classes and to 
use then for testing classes individually. After the classes are integrated into 
a single program, you only need ensure that the interpreter is invoked on the 
class that contains the “real” main method. 


Two runtime errors can occur if the interpreter is not successful in finding 
and running the program. 


NoClassDefFoundError 


The interpreter must be able to find the file containing a class with the 
main method, for example, Test.class. If packages are not used, this 
must be in the directory where the interpreter is executed. Check that the 
name of the class is the same as the name of the file without the extension. 
Case is significant! 


Warning! If you are compiling and running Java from a command window 
or shell with a history facility, you are likely to encounter this error. First, 
you compile the program: 


javac MyClass.java 


and then you recall that line and erase the c from javac to obtain the 
command for the interpreter: 


java MyClass.java 


Unfortunately, MyClass . java is not the name of the class so you will get 
this exception. You must erase the . java extension as well to run the 
interpreter: 


java MyClass 


If you are using packages, the main class must be in a subdirectory of that 
name. For example, given: 


package projecti1.userinterface; 
Class Test { 
public static void main(String[] args) { 


} 
} 


the file Test ..class must be located in the directory userinterface 
that is a subdirectory of project1 that is a subdirectory of the directory 
where the interpreter is executed: 


c:\projects> dir 
<DIR> projecti 

c:\projects> dir projecti 
<DIR> userinterface 

c:\projects> dir projecti\userinterface 
Test.class 


The program is invoked by giving the fully qualified name made up of the 
package names and the class name: 


c:\projects> java projecti.userinterface.Test 


NoSuchMethodFoundError: main 


This error will occur if there is no method main in the class, or if the 
declaration is not precisely correct: the Static modifier, the void return 
type, the method name main written in lower case, and one parameter of 


type String|[ ]. If you forget the public modifier, the error message is 
Main method not public. 


Assignment and Equality in Java 
Because Java uses reference semantics, there are potential errors that can 
occur with the assignment statement and the equality operator. 


Java programmers make mistakes in the use of the assignment and equality 
operators, especially when strings are used. The concept of reference 
semantics is (or should be) explained in detail in your textbook, so we limit 
ourselves to a reminder of the potential problems. 


String equality 

Given: 

String si = "abcdef"; 
String s2 = "abcdef"; 
String s3 = "abc" + "def"; 
String s4 = "abcdef" + ""; 
String s5 =si1+"": 
String ti = "abc"; 

String t2 = "def"; 

String s6 = t1 + t2; 


all strings Sn are equal when compared using the method equals in the 
class String that compares the contents pointed to by the reference: 


if (s1.equals(s5) ) // Condition evaluates 
to true 


The string literal" abcdef" is stored only once, so strings $1, S2 and 
(perhaps surprisingly) S3 and S4 are also equal when compared using the 
equality operator == that compares the references themselves: 


if (si == s3) // Condition evaluates 
to true 


However, $5 and S6 are not equal (==) to $1 through S4, because their 
values are created at runtime and stored separately; therefore, their 


references are not the same as they are for the literals created at compile- 
time. 


Always use equals rather than == to compare strings, unless you can 
explain why the latter is needed! 


Assignment of references 


The assignment operator copies references, not the contents of an object. 
Given: 


int[] alt = { 1, 2, 3, 4, 5 }; 
int[] a2 = a1; 
al[0O] = 6; 


since a2 points to the same array, the value of a2[ 0] is also changed to 6. 
To copy an array, you have to write an explicit loop and copy the elements 
one by one. 


To copy an object pointed to by a reference, you can create a new object 
and pass the old object as a parameter to a constructor: 


Class MyClass { 

int x; 

MyClass(int y) { x =y; } 

MyClass(MyClass myclass) { this.x = myclass.x; } 
} 


Class Test { 
public static void main(String[] args) { 
MyClass myclass1 new MyClass(5); 
MyClass myclass2 new MyClass(myclass1); 
myclass1.x = 6; 
System.out.println(myclass1.x); // Prints 6 
System.out.println(myclass2.x); // Prints 5 


Alternatively, you can use Clone as described in Java textbooks. 


Debugging Java Programs Without a Debugger 

This module contains tips for debugging a Java program without a 
debugger, primarily by printing out data during the execution of the 
program. 


Debugging is perhaps best done using a debugger such as those provided by 
integrated development environments. Nevertheless, many programmers 
debug programs by inserting print statements. This section describes some 
of the techniques that can be used in Java. 


Printing number data and arrays 


The methods System.out.print and System.out.println are 
predefined for primitive types as well as for strings: 


int 1 = 1; 

double d = 5.2; 
System.out.print(i); 
System.out.printiln(d); 


Furthermore, automatic conversion to String type is performed by the 
concatenation operator +: 


System.out.println("d = "+d+ "and i= " +1); 


The print statements can not print an entire array, so a method must be 
written: 


public static void print(int[] a) { 
for (int 1 = 0; 1 < a.length; i++) 
System.out.print(a[i]); 
System.out.printin(); 
t 


public static void main(String[] args) { 
int[] a = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }; 


print(a); 


Since the number of elements of an array can be large, it is better to write 
the method so that it inserts a newline after printing a fixed number of 
elements: 


public static void print(int[] a) { 
for (int 1 = 0; i < a.length; i++) { 
System.out.print(a[i]); 
if (1 % 8 == 7) System.out.printlin(); 
I 
System.out.println(); 


} 


You can put this static method in a publicly accessible class and use it to 
print any integer array. Similar methods can be written for the other 
primitive types. 


Converting objects to strings 


Within the class Object, the root class for all other classes, a method 
toString is declared. The default implementation will not give useful 
information, so it is a good idea to override it in each class that you write: 


Class Node { 

int key; 

double value; 

public String toString() { 

return "The value at key " + key + " is " + va 

lue; 

} 
} 


Then, you can simply call the print statements for any object of this class 
and the conversion to String is done automatically: 


Node node = new Node(); 
System.out.println(node) ; 


The predefined class java. util.Arrays constains a lot of useful 
(static) methods for working with arrays, among them toString methods 
for arrays whose elements are of any primitive type: 


int[] a = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }; 
System.out.println(java.util.Arrays.toString(a)); 


or 
import java.util.Arrays; 
System.out.println(Arrays.toString(a)); 


You will receive a predefined representation of the array (the elements are 
separated by commas), so if you want an alternate representation (such as 
printing on multiple lines) you will have to write your own print method as 
we did in the previous section. 


An array of objects of any reference type can be printed by defing a single 
method since any object can be converted to Object: 


public static void print(Object[] a) { 
for (int 1 = 0; 1 < a.length; i++) 
System.out.print(a[i]); 
System.out.printin(); 
t 


Node[] nodes = new Node[]; 

ei 4 // Create elements 
of the array 
print(nodes); 


or by calling the predefined method deepToString: 


Node[] nodes = new Node[]; 

cit // Create elements 
of the array 
System.out.printin(java.util.Arrays.deepToString(n 
ode) ); 


Forcing a stack trace 


Suppose that you have isolated a bug to a certain method but you do not 
know which call of that method was responsible. You can force the 
interpreter to print a trace of the call stack by inserting the line: 


new Exception().printStackTrace(); 


within the method. It creates a new object of type Exception and then 
invokes the method printStackTrace. Since the exception is not 
thrown, the execution of the program proceeds with no interruption. A 
program can always be terminated by calling System.exit(n) for an 
integer Nn. 


Leave the debug statements in the program 


Once you have found a bug, it is tempting to delete the print statements 
used for debugging, but it is better not to do so because you may need them 
in the future. You can comment out the statements that you don't need, but a 
better solution is to declare a global constant and then use it to turn the print 
statements on and off: 


public class Global { 
public static boolean DEBUG = false; 
public static void print(int[] a) {...} 
public static void print(Object[] a) {...} 
} 


if (Global.DEBUG) Global.print(nodes); 


